
class cLayer(object):

    """
     Esta clase representa una de las capas que componen la escena. Las capas se
     montan unas encima de otras teniendo en cuenta su orden de profundidad para
     montar el resultado final.

    :version:
    :author:
    """

    """ ATTRIBUTES

     Id asignado a la capa.

    id  (public)

     Indice de profundidad. Cuanto menor sea este valor antes se procesará una capa.

    zindex  (public)

     Indica si la capa se encuentra pausada.

    paused  (public)

     Diccionario con todas las entidades que contiene la capa. Estas entidades son
     las que ofrecen una representacion grafica para la capa, como por ejemplo el
     fondo en el caso de la capa de background, los elementos del juego en el caso de
     la capa principal, la interfaz de usuario, los menus, los mensajes, etc.

    entities  (public)

     Referencia a la escena padre a la que pertenece esta capa.

    scene  (public)

    """

    def add_entity(self, self, entity):
        """
         Añade una entidad a la lista de entidades disponibles en la capa. Devuelve el id
         asignado a la entidad.

        @param cLayer self : 
        @param cVisualEntity entity : 
        @return  :
        @author
        """
        pass

    def get_entity(self, self, entity_id):
        """
         Obtiene una entidad de la lista de entidades disponibles.

        @param cLayer self : 
        @param int entity_id : 
        @return cVisualEntity :
        @author
        """
        pass

    def remove_entity(self, self, entity_id):
        """
         Retira una entidad de la lista de entidades

        @param cLayer self : 
        @param int entity_id : 
        @return  :
        @author
        """
        pass



